01 DJGJTflL RESEARCH 

Post Office Box 579, Pacific Grove, California 93950, (408) 649-3896 



ASSEMBLER (ASM) 
USER'S GUIDE 



Copyright (c) 1976, 1978 by Digital Research. All rights 
reserved. No part of this publication may be reproduced, 
transmitted, transcribed, stored in a retrieval system, ot 
translated into any language or computer language, in any 
form or by any means, electronic, mechanical, magnetic, 
optical, chemical, manual or otherwise, without the prior 
written permission of Digital Research, Post Office Box 579 
Pacific Grove, California 93950. 

Disclaimer . 

Digital Research makes no representations or warranties with 
respect to the contents hereof and specifically disclaims any 
implied warranties of merchantabilitv or fitness for #in\r 

right to revise this publication and to make chancres from 



cnanges. 



Dl DJGJTflL RESEARCH 

Post Office Box 579, Pacific Grove, California 93950, (408) 649-3896 



CP/M ASSEMBLER (ASM) 
USER'S GUIDE 



COPYRIGHT (c) 1976, 1978 
DIGITAL RESEARCH 



Copyright (c) 1976, 1978 by Digital Research. All rights reserved. 
No part of this publication may be reproduced, transmitted, transcribed, 
stored in a retrieval system, or translated into any language or computer 
language, in any form or by any means, electronic, mechanical, magnet- 
ic optical, chemical, manual or otherwise, without the prior written 
permission of Digital Research, Post Office Box 579, Pacific Grove, 
California 93950. 



Disclaimer 



Digital Research makes no representations or warranties with respect to 
the contents hereof and specifically disclaims any implied warranties of 
merchantability or fitness for any particular purpose. Further, Digital 
Research reserves the right to revise this publication and to make 
changes from time to time in the content hereof without obligation of 
Digital Research to notify any person of such revision or changes. 



Table of Contents 



Section Page 

1. INTRODUCTION 1 

2. PROGRAM fORMAT 2 

3. FORMING THE CPERAND 4 

3»1* labels .... 4 

3.2. Numeric Constants 4 

3.3. Reserved Words 5 

3.4. String Constants .... 6 

3.5* Arithmetic and Logical Operators 6 

3.6. Precedence of Operators 7 

4. ASSEMBLER DIRECTIVES 8 

4.1. The ORG Directive 8 

4.2. The END Directive 9 

4.3. Hie EQU Directive 9 

4.4. The SET Directive ... 10 

4.5. The IF and ENDIF Directives 10 

4.6. The DB Directive 11 

4.7. The DW Directive 12 

5. OPERATION OODES 12 

5.1. Jumps, Calls, and Returns 13 

5.2. Immediate Operand Instructions 14 

5. 3. Increment and Decrement Instructions 14 

5*4. Data Movement Instructions 14 

5. 5. Arithmetic Logic Unit Operations 15 

5.6. Control Instructions 16 

6. ERROR tGSSAGES 16 

7. A SAMPLE SESSION 17 



CP/M Assembler User's Guide 



1. INTRODUCTION. 

The CP/M assembler reads assembly language source files from the diskette, 

and produces 8080 machine language in Intel hex format. The CP/M assembler is 
initiated by typing 

ASM filename 

or 

ASM filename. parms 

In both cases, the assembler assumes there is a file on the diskette with the 
name 

filename .ASM 

which contains an 8080 assembly language source file. The first and second 
forms shown above differ only in that the second form allows parameters to be 
passed to the assembler to control source file access and hex and print file 
destinations. 

In either case, the CP/M assembler loads, and prints the message 

CP/M ASSEMBLER VER n.n 

where n.n is the current version number. In the case of the first command, 
the assembler reads the source file with assumed file type "ASM* 4 and creates 
two output files 

filename. HEX 

and 

filename. PRN 

the "HEX" file contains the machine code corresponding to the original program 
in Intel hex format, and the "PRN" file contains an annotated listing showing 
generated machine code, error flags, and source lines. If errors occur during 
translation, they will be listed in the PRN file as well as at the console 

The second command form can be used to redirect input and output files 
from their defaults. In this case f the "parms" portion of the command is a 
three letter group which specifies the origin of the source file, the 
destination of the hex file, and the destination of the print file. The form 
is 

filename .plp2p3 
vAiere pi, p2, and p3 are single letters 

pi: A,B, y designates the disk name which contains 
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the source file 
p2: A f B f . .., Y designates the disk name which will re- 
ceive the hex file 
Z skips the generation of the hex file 

p3: A,B, . .., Y designates the disk name which will re- 
ceive the print file 
X places the listing at the console 

Z skips generation of the print file 



Thus, the command 



ASM X.AAA 



indicates that the source file (X.ASM) is to be taken from disk A, and that 
the hex (X.HEX) and print (X.PRN) files are to be created also on disk A, 
This form of the command is implied if the assembler is run from disk A. That 
is, given that the operator is currently addressing disk A, the above command 
is equivalent to 



ASM X 



The command 



ASM X.ABX 



indicates that the source file is to be taken from disk A, the hex file is 
placed on disk B r and the listing file is to be sent to the console. The 
command 



ASM X.BZZ 



takes the source file from disk B, and skips the generation of the hex and 
print files (this command is useful for fast execution of the assembler to 
check program syntax) . 

The source program format is compatible with both the Intel 8080 assembler 
(macros are not currently implemented in the CP/M assembler, however) , as well 
as the Processor Technology Software Package #1 assembler. That is, the CP/M 
assembler accepts source programs written in either format. There are certain 
extensions in the CP/M assembler vtoich make it somewhat easier to use. These 
extensions are described below. 



2. PROGRAM FORMAT. 



An assembly language program acceptable as input to the assembler consists 
of a sequence of statements of the form 

line# label operation operand ; comment 

where any or all of the fields may be present in a particular instance. Each 
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~embly language statement is terminated with a carriage return and line feed 
(the line feed is inserted automatically by the ED program), or with the 
character "!" which is a treated as an end-of-line by the assembler (thus, 
multiple assembly language statements can be written on the same physical line 
if separated by exclaim symbols). 

The line# is an optional decimal integer value representing the source 
program line number, which is allowed on any source line to maintain 
compatibility with the Processor Technology format. In general, these line 
numbers will be inserted if a line-oriented editor is used to construct the 
original program, and thus ASM ignores this field if present. 

The label field takes the form 

identifier 

or 

identifier: 

and is optional, except vrtiere noted in particular statement types. The 
identifier is a sequence of alphanumeric characters (alphabetics and numbers) , 
where the first character is alphabetic. Identifiers can be freely used by 
the programmer to label elements such as program steps and assembler 
directives, but cannot exceed 16 characters in length. All characters are 
significant in an identifier, except for the embedded dollar symbol ($) which 
can be used to improve readability of the name. Further, all lower case 
alphabetics become are treated as if they were upper case. Note that the ":" 
following the identifier in a label is optional (to maintain compatibility 
between Intel and Processor Technology) . Thus, the following are all valid 
instances of labels 

x xy long$name 

x: yxl: longer $named$data: 

X1Y2 Xlx2 x234$5678$9012$3456: 



The operation field contains either an assembler directive, or pseudo 
operation, or an 8080 machine operation code. The pseudo operations and 
machine operation codes are described below. 

The operand field of the statement, in general, contains an expression 
formed out of constants and labels, along with arithmetic and logical 
operations on these elements. Again, the complete details of properly formed 
expressions are given below. 

The comment field contains arbitrary characters following the W ; M symbol 
until the next real or logical end-of-line. These characters are read, 
listed, and otherwise ignored by the assembler. In order to maintain 
compatability with the Processor Technology assembler, the CP/M assembler also 
treat statements vrtiich begin with a in column one as comment statements, 
which are listed and ignored in the assembly process. Note that the Processor 
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Technology assembler has the side effect in its operation of ignoring the 
characters after the operand field has been scanned. This causes an ambiguous 
situation when attempting to be compatible with Intel's language, since 
arbitrary expressions are allowed in this case. Hence, programs vfoich use 
this side effect to introduce comments, must be edited to place a ";" before 
these fields in order to assemble correctly. 

The assembly language program is formulated as a sequence of statements of 
the above form f terminated optionally by an END statement. All statements 
following the END are ignored by the assembler. 



3. FORMING THE OPERAND. 

In order to completely describe the operation codes and pseudo operations, 
it is necessary to first present the form of the operand field, since it is 
used in nearly all statements. Expressions in the operand field consist of 
simple operands (labels, constants, and reserved words) , combined in properly 
formed subexpressions by arithmetic and logical operators. Ihe expression 
computation is carried out by the assembler as the assembly proceeds. Each 
expression must produce a 16-bit value during the assembly. Further, the 
number of significant digits in the result must not exceed the intended use. 
That is, if an expression is to be used in a byte irove immediate instruction, 
then the most significant 8 bits of the expression must be zero. The 
restrictions on the expression significance is given with the individual 
instructions. 

3.1. Labels. 

As discussed above, a label is an identifier which occurs on a particular 
statement. In general, the label is given a value determined by the type of 
statement v*iich it precedes. If the label occurs on a statement vfriich 
generates machine code or reserves memory space (e.g, a MOV instruction, or a 
DS pseudo operation) , then the label is given the value of the program address 
which it labels. If the label precedes an EQU or SET, then the label is given 
the value vrtiich results from evaluating the operand field. Except for the SET 
statement, an identifier can label only one statement. 

When a label appears in the operand field, its value is substituted by the 
assembler. This value can then be combined with other operands and operators 
to form the operand field for a particular instruction. 

3.2. Numeric Constants. 

A numeric constant is a 16-bit value in one of several bases. The base, 
called the radix of the constant, is denoted by a trailing radix indicator. 
The radix indicators are 

B binary constant (base 2) 
octal constant (base 8) 
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Q octal constant (base 8) 

D decimal constant (base 10) 

H hexadecimal constant (base 16) 

is an alternate radix indicator for octal numbers since the letter is 
easily confused with the digit 0. Any numeric constant vdiich does not 
terminate with a radix indicator is assumed to be a decimal constant. 

A constant is thus composed as a sequence of digits, followed by an 
optional radix indicator, vhere the digits are in the appropriate range for 
the radix. That is binary constants must be composed of and 1 digits, octal 
constants can contain digits in the range - 7, while decimal constants 
contain decimal digits. Hexadecimal constants contain decimal digits as well 
as hexadecimal digits A (10D) , B (11D) , C (12D) , D (13D) , E (14D) , and F 
(15D). Note that the leading digit of a hexadecimal constant must be a 
decimal digit in order to avoid confusing a hexadecimal constant with an 
identifier (a leading will always suffice) . A constant composed in this 
manner must evaluate to a binary number which can be contained within a 16-bit 
counter, otherwise it is truncated on the right by the assembler. Similar to 
identifiers, imbedded "$ M are allowed within constants to improve their 
readability. Finally, the radix indicator is translated to upper case if a 
lower case letter is encountered. The following are all valid instances of 
numeric constants 

1234 1234D 1100B 1111$0000$1111$0000B 
1234H 0FFEH 33770 33$77$22Q 
3377o 0fe3h 1234d 0ffffh 



3.3. Reserved Words. 



There are several reserved character sequences vfaich have predefined 
meanings in the operand field of a statement. The names of 8080 registers are 
given below, viiich, when encountered, produce the value shown to the right 



A 


7 


B 





C 


1 


D 


2 


E 


3 


H 


4 


L 


5 


M 


6 


SP 


6 


PSW 


6 



(again, lower case names have the same values as their upper case 
equivalents). Machine instructions can also be used in the operand field, and 
evaluate to their internal codes. In the case of instructions which require 
operands, **iere the specific operand becomes a part of the binary bit pattern 
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op+fre instruction (e.g, MDV A,B) , the value of the instruction (in this case 
MOV) is the bit pattern of the instruction with zeroes in the optional fields 
(e.g, M3V produces 40H) . 

When the symbol "$ M occurs in the operand field (not inbedded within 
identifiers and numeric constants) its value becomes the address of the next 
instruction to generate, not including the instruction contained wi thing the 
current logical line, 

3.4, String Constants, 

String constants represent sequences of ASCII characters, and are 
represented by enclosing the characters within apostrophe symbols ( ') . All 
strings must be fully contained within the current physical line (thus 
allowing M I" symbols within strings), and must not exceed 64 characters in 
length. The apostrophe character itself can be included within a string by 
representing it as a double apostrophe (the two keystrokes ") , which becomes 
a single apostrophe **ien read by the assembler. In most cases, the string 
length is restricted to either one or two characters (the DB pseudo operation 
is an exception) , in which case the string becomes an 8 or 16 bit value, 
respectively. Two character strings become a 16-bit constant, with the second 
character as the low order byte, and the first character as the high order 
byte. 

The value of a character is its corresponding ASCII code. There is no 
case translation within strings, and thus both upper and lower case characters 
can be represented. Note however, that only graphic (printing) ASCII 
characters are allowed within strings. Valid strings are 

'A' 'AB' 'ab' 'c' 

a 

'Walla Walla Wash. ' 

'She said ' 'Hello " to me. ' 

'I said "Hello" to her.' 



3.5. Arithmetic and Logical Operators. 

The operands described above can be combined in normal algebraic notation 
using any combination of properly formed operands, operators, and 
parenthesized expressions. The operators recognized in the operand field are 

a + b unsigned arithmetic sum of a and b 

a - b unsigned arithmetic difference between a and b 

+ b unary plus (produces b) 

- b unary minus (identical to - b) 

a * b unsigned magnitude multiplication of a and b 

a / b msigned magnitude division of a by b 

a MOD b remainder after a / b 

NOT b logical inverse of b (all 0's become 1's, l's 

become 0's), where b is considered a 16-bit value 
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a AND b bit-by-bit logical and of a and b 

a OR b bit-by-bit logical or of a and b 

a XOR b bit-by-bit logicl exclusive or of a and b 

a SHL b the value which results from shifting a to the 

left by an amount b, with zero fill 
a SHR b the value which results from shifting a to the 

right by an amount b, with zero fill 

In each case, a and b represent simple operands (labels, numeric 
constants, reserved words, and one or two character strings) , or fully 
enclosed parenthesized subexpressions such as 



10f20 10h+37Q LI /3 (L2+4) SHR 3 

('a' and 5fh) + '0' fB'+B) OR (PSW+M) 
(l+(2+c)) shr (A-(B+1)) 

Note that all computations are performed at assennbly time as 16-bit unsigned 
operations. Thus, -1 is computed as 0-1 which results in the value 0ffffh 
(i.e., all l's). The resulting expression must fit the operation code in 
which it is used. If, for example, the expression is used in a ADI (add 
immediate) instruction, then the high order eight bits of the expression must 
be zero. As a result, the operation "ADI -1" produces an error message (-1 
becomes 0f fffh vhich cannot be represented as an 8 bit value) , while "ADI (-1) 
AND 0FFH" is accepted by the assembler since the "AND" operation zeroes the 
high order bits of the expression. 



3.6. Precedence of Operators. 



As a convenience to the programmer, ASM assumes that operators have a 
relative precedence of application which allows the programmer to write 
expressions without nested levels of parentheses. The resulting expression 
has assumed parentheses which are defined by the relative precedence. The 
order of application of operators in unparenthesize expressions is listed 
below. Operators listed first have highest precedence (they are applied first 
in an unparenthesized expression) , vtfiile operators listed last have lowest 
precedence. Operators listed on the same line have equal precedence, and are 
applied from left to right as they are encountered in an expression 



* / MOD SHL SHR 
- + 
NOT 
AND 
OR XOR 



Thus, the expressions shown to the left below are interpreted by the assembler 
as the fully parenthesize expressions shown to the right below 

a*b + c (a * b) + c 

a + b * c a+(b*c) 
a MOD b * c SHL d ( (a MOD b) * c) SHL d 
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a OR b AND NOT c + d SHL e 



a OR (b AND (NOT (c + (d SHL e) ) ) ) 



Balanced parenthesized subexpressions can always be used to override the 
assumed parentheses, and thus the last expression above could be rewritten to 
force application of operators in a different order as 

(a OR b) AND (NOT c) + d SHL e 

resulting in the assumed parentheses 

(a OR b) AND ( (NOT c) + (d SHL e) ) 

Note that an mparenthesized expression is well-formed only if the expression 
which results from inserting the assumed parentheses is well-formed. 

4. ASSEMBLER DIRECTIVES. 

Assembler directives are used to set labels to specific values during the 
assnfoly, perform conditional assembly, define storage areas, and specify 
starting addresses in the program. Each assembler directive is denoted by a 
"pseudo operation" which appears in the operation field of the line. Hie 
acceptable pseudo operations are 



ORG 


set the program or data origin 


END 


end program, optional start address 


EQU 


numeric "equate" 


SET 


numeric "set" 


IF 


begin conditional assembly 


ENDIF 


end of conditional assembly 


DB 


define data bytes 


DW 


define data words 


D6 


define data storage area 



The individual pseudo operations are detailed below 

4.1. The ORG directive. 

The ORG statement takes the form 

label ORG expression 

where "label" is an optional program label, and expression is a 16-bit 
expression, consisting of operands which are defined previous to the ORG 
statement. The assembler begins machine code generation at the location 
specified in the expression. There can be any number of ORG statements within 
a particular program, and there are no checks to ensure that the programmer is 
not defining overlapping memory areas. Note that most programs written for 
the CP/M system begin with an ORG statement of the form 

ORG 100H 
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which causes machine code generation to begin at the base of the CP/M 
transient program area. If a label is specified in the ORG statement, then 
the label is given the value of the expression (this label can then be used in 
the operand field of other statements to represent this expression) . 

4.2. The END directive. 

The END statement is optional in an assembly language program, but if it 
is present it must be the last statement (all subsequent statements are 
ignored in the assembly) . The two forms of the END directive are 

label END 

label END expression 

where the label is again optional. If the first form is used, the assembly 
process stops, and the default starting address of the program is taken as 
0000. Otherwise, the expression is evaluated, and becomes the program 
starting address (this starting address is included in the last record of the 
Intel formatted machine code ''hex" file vtoich results from the assembly) . 
Thus, most CP/M assembly language programs end with the statement 

END 100H 

resulting in the default starting address of 100H (beginning of the transient 
program area) . 

4.3. The EQU directive. 

The EQU (equate) statement is used to set up synonyms for particular 
numeric values, the form is 

label EQU expression 

where the label must be present, and must not label any other statement. The 
assembler evaluates the expression, and assigns this value to the identifier 
given in the label field. The identifier is usually a name which describes 
the value in a no re human-oriented manner. Further, this name is used 
throughout the program to "parameterize" certain functions. Suppose for 
example, that data received from a Teletype appears on a particular input 
port, and data is sent to the Teletype through the next output port in 
sequence. The series of equate statements could be used to define these ports 
for a particular hardware environment 

TTYRASE EQU 10H ;BASE PORT NUMBER FOR TTY 

TTYIN EQU TTYBASE ;TTY DATA IN 
TTYOOT EQU TTYBASE+1 ;TTY DATA OUT 

At a later point in the program, the statements which access the Teletype 
could appear as 
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IN TTY IN ;READ TTY DATA TO REG-A 

OUT TTYOOT ; WRITE DATA TO TTY FROM RBG-A 

making the program no re readable than if the absolute i/o ports had been 
used. Further, if the hardware environment is redefined to start the Teletype 
communications ports at 7FH instead of 10H, the first statement need only be 
changed to 

TTY BASE EQU 7FH ;BASE PORT NUMBER FOR TTY 

and the program can be reassembled without changing any other statements. 

4.4. The SET Directive. 

The SET statement is similar to the EQU, taking the form 

label SET expression 

except that the label can occur on other SET statements within the program. 
The expression is evaluated and becomes the current value associated with the 
label. Thus, the EQU statement defines a label with a single value, vfaile the 
SET statement defines a value which is valid from the current SET statement to 
the point where the label occurs on the next SET statement. The use of the 
SET is similar to the EQU statement, but is used irost often in controlling 
conditional assembly. 

4.5. The IF and ENDIF directives. 

The IF and ENDIF statements define a range of assembly language statements 
which are to be included or excluded during the assembly process. The form is 

IF expression 
statements 
statement#2 
... 

statement#n 
ENDIF 

Upon encountering the IF statement, the assembler evaluates the expression 
following the IF (all operands in the expression must be defined ahead of the 
IF statement) . If the expression evaluates to a non-zero value, then 
statements through statements are assembled; if the expression evaluates to 
zero, then the statements are listed but not assembled. Conditional assembly 
is often used to write a single "generic" program which includes a number of 
possible run-time environments, with only a few specific portions of the 
program selected for any particular assembly. The following program segments 
for example, might be part of a program which communicates with either a 
Teletype or a CRT console (but not both) by selecting a particular value for 
TTY before the assembly begins 
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TWJE 


EQU 


0FFFFH ; DEFINE VALUE OF TRUE 


FALSE 


EQU 


NOT TRJE ; DEFINE VALUE OF FALSE 


• 

TTY 


EQU 


TPUE ;THJE IF TTY, FALSE IF CRT 


TTYBASE EQU 


10H ; 


•BASE OF TTY I/O PORTS 


CRTBASE 


EQU 


20H ; 


-BASE OF CRT I/O PORTS 




IF 


TTY ; 


» ASSEMBLE RELATIVE TO TTYBASE 


CONIN 


EQU 


TTYBASE ; 


•CONSOLE INPUT 


ooNOtrr 


EQU 


TTYBASE+1 ; 


•CONSOLE OUTPUT 




ENDIF 






• 


IF 


NOT TIY 


•ASSEMBLE RELATIVE TO CRTBASE 


OONIN 


EQU 


CRTBASE 


•CONSOLE INPUT 


OONOOT 


EQU 


CRTBASE+1 


•CONSOLE OUTPUT 




ENDIF 








• • • 

IN 


OONIN 


?READ CONSOLE DATA 




• • • 

OUT 


OONOUT 


; WRITE CONSOLE DATA 



In this case, the program would assemble for an environment vdiere a Teletype 
is connected , based at port 10H. The statement defining TTY could be changed 
to 

TTY EQU FALSE 
and, in this case, the program would assemble for a CRT based at port 20H. 
4.6. The DB Directive. 

The DB directive allows the programmer to define initialize storage areas 
in single precision (byte) format. The statement form is 

label DB e#l, e#2, e#n 

where e#l through e#n are either expressions which evaluate to 8-bit values 
(the high order eight bits must be zero) , or are ASCII strings of length no 
greater than 64 characters. There is no practical restriction on the nunber 
of expressions included on a single source line. The expressions are 
evaluated and placed sequentially into the machine code file following the 
last program address generated by the assembler. String characters are 
similarly placed into memory starting with the first character and ending with 
the last character. Strings of length greater than two characters cannot be 
used as operands in more complicated expressions (i.e., they must stand alone 
between the commas) . Note that ASCII characters are always placed in memory 
with the parity bit reset (0). Further, recall that there is no translation 
from lower to upper case within strings. The optional label can be used to 
reference the data area throughout the remainder of the program. Examples of 
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valid DB statements are 



data: DB 0,1,2,3,4,5 

DB data and 0ffh, 5, 377Q, 1+2+3+4 

signon: DB 'please type your name',cr,lf ,0 

EB 'AB' SHR 8, 'C, 'DE' AND 7FH 



4.7. The DW Directive. 

The DW statement is similar to the DB statement except double precision 
(two byte) words of storage are initialized. The form is 

label DW e#l, e#2, e#n 

vfiere e#l through e#n are expressions vdiich evaluate to 16-bit results. Note 
that ASCII strings of length one or two characters are allowed, but strings 
longer than two characters disallowed. In all cases, the data storage is 
consistent with the 8080 processor: the least significant byte of the 
expression is stored forst in memory, followed by the most significant byte. 
Examples are 

doub: DW 0ffefh,doub+4,signon-$, 255+255 

DW 'a', 5, 'ab', 'CD', 6 shl 8 or lib 



4.8. The DS Directive. 

The DS statement is used to reserve an area of uninitialized memory, and 
takes the form 

label DS expression 

where the label is optional. The assembler begins subsequent code generation 
after the area reserved by the DS. Thus, the DS statement given above has 
exactly the same effect as the statement 

label: EQU $ ? LABEL VALUE IS CURRENT CODE LOCATION 
ORG Expression ;MOVE PAST RESERVED AREA 



5. OPERATION OODES. 

Assembly language operation codes form the principal part of assembly 
language programs, and form the operation field of the instruction. In 
general, ASM accepts all the standard imemonics for the Intel 8080 
microcomputer, which are given in detail in the Intel manual "8080 Assembly 
Language Programming Manual." Labels are optional on each input line and, if 
included, take the value of the instruction address immediately before the 
instruction is issued. The individual operators are listed breifly in the 
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following sections for completeness, although it is understood that the Intel 
manuals should be referenced for exact operator details. In each case, 

e3 represents a 3-bit value in the range 0-7 

which can be one of the predefined registers 
A r B, C, D, E, H, L, M, SP, or PSW. 

e8 represents an 8-bit value in the range 0-255 

el6 represents a 16-bit value in the range 0-65535 

which can themselves be formed from an arbitrary combination of operands and 
operators. In some cases, the operands are restricted to particular values 
within the allowable range, such as the PUSH instruction. These cases will be 
noted as they are encountered. 

In the sections which follow, each operation codes is listed in its most 
general form, along with a specific example, with a short explanation and 
special restrictions. 



5.1. Jumps, Calls, and Returns. 

The Jump, Call, and Return instructions allow several different forms 
which test the condition flags set in the 8080 microcomputer CPU. Hie forms 
are 



JMP 


el6 


JMP 


LI 


Jump 


unconditionally to label 


JNZ 


el6 


JMP 


L2 


Jump 


on non zero condition to label 


JZ 


el6 


JMP 


100H 


Jump 


on zero condition to label 


JNC 


el6 


JNC 


LL+4 


Jump 


no carry to label 


JC 


el6 


JC 


L3 


Jump 


on carry to label 


JPO 


el6 


JPO $+8 


Jump 


on parity odd to label 


JPE 


el6 


JPE 


L4 


Jump 


on even parity to label 


JP 


el6 


JP 


GAMMA 


Jump 


on positive result to label 


JM 


el6 


JM 


al 


Jump 


on minus to label 


CALL 


el6 


CALL SI 


Call 


subroutine unconditionally 


CNZ 


el6 


CNZ 


S2 


Call 


subroutine if non zero flag 


CZ 


el6 


CZ 


100H 


Call 


subroutine on zero flag 


CNC 


el6 


CNC 


Sl+4 


Call 


subroutine if no carry set 


CC 


el6 


CC 


S3 


Call 


subroutine if carry set 


CPO 


el6 


CPO 


$+8 


Call 


subroutine if parity odd 


CPE 


el6 


CPE 


S4 


Call 


subroutine if parity even 


CP 


el6 


CP 


GAMMA 


Call 


subroutine if positive result 


CM 


el6 


CM 


bl$c2 


Call 


subroutine if minus flag 


ROT 


e3 


RST 





Programmed "restart", equivalent to 



CALL 8*e3, except one byte call 
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RET 


4- 1 1 ^ 

rwrCUL 1 1 




KNZ 






Ki6 


IMC ULiL 1 1 


i *F 7PTD fl an cipt 




i\c LUL 1 1 


•i f no narrv 

xi i iv/ mil l jr 


RC 


Return 


if carry flag set 


RPO 


Return 


if parity is odd 


RPE 


Return 


if parity is even 


RP 


Return 


if positive result 


RM 


Return 


if minus flag is set 



5.2. Immediate Operand Instructions. 



Several instructions are available vrtiich load single or double precision 
registers, or single precision memory cells, with constant values, along with 
instructions vvhich perform immediate arithmetic or logical operations on the 
accumulator (register A) . 



MVI 


e3,e8 


MVI 


B,255 


AD I 


e8 


ADI 


1 


ACI 


e8 


ACI 


0FFH 


SUI 


e8 


SUI 


L + 3 


SBI 


e8 


SBI 


L AND 11B 


AN I 


e8 


ANI 


$ AND 7FH 


XRI 


e8 


XRI 


1111$0000B 


ORI 


e8 


ORI 


L AND 1+1 


CPI 


e8 


CPI 


a 



Move immediate data to register A, B, 
C, D, E, H, L, or M (memory) 
Add immediate operand to A without carry 
A3d immediate operand to A with carry 
Subtract from A without borrow (carry) 
Subtract from A with borrow (carry) 
Logical "and'* A with immediate data 
"Exclusive or" A with immediate data 
Logical "or" A with immediate data 
Compare A with immediate data (same 
as SUI except register A not changed) 



LXI e3,el6 LXI B,100H Load extended immediate to register pair 

(e3 must be equivalent to B,D,H, or SP) 



5.3. Increment and Decrement Instructions. 

Instructions are provided in the 8080 repetoire for incrementing or 
decrementing single and double precision registers. The instructions are 

INR e3 INR E Single precision increment register (e3 

produces one of A, B, C, D, E, H, L, M) 
DCR e3 DCR A Single precision decrement register (e3 

produces one of A, B, C, D, E, H, L, M) 
INX e3 INX SP Double precision increment register pair 

(e3 must be equivalent to B,D,H, or SP) 
DCX e3 DCX B Double precision decrement register pair 

(e3 must be equivalent to B,D,H, or SP) 



5.4. Data Movement Instructions. 
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Instructions which move data from memory to the CPU and from CPU to 
memory are given below 



MOV e3,e3 MDV A,B 



LDAX e3 


LDAX B 


STAX e3 


STAX D 


LHLD el 6 


LHLD Ll 


SHLD el6 


SHLD L5+X 


LEA el6 


LDA Gamma 


STA el6 


STA X3-5 


POP e3 


POP PSW 


PUSH e3 


PUSH B 


IN e8 


IN 


OUT e8 


OUT 255 


XTHL 




PCHL 




SPHL 




XCHG 





Move data to leftmost element from right- 
most element (e3 produces one of A,B,C 
D,E,H,L, or M). MDV M,M is disallowed 
Load register A from computed address 
(e3 must produce either B or D) 
Store register A to computed address 
(e3 must produce either B or D) 
Load HL direct from location el6 (double 
precision load to H and L) 
Store HL direct to location el6 (double 
precision store from H and L to memory) 
Load register A from address el6 
Store register A into memory at el6 
Load register pair from stack , set SP 
(e3 must produce one of B, D, H, or PSW) 
Store register pair into stack, set SP 
(e3 must produce one of B, D, H, or PSW) 
Load register A with data from port e8 
Send data from register A to port e8 
Exchange data from top of stack with HL 
Fill program counter with data from HL 
Fill stack pointer with data from HL 
Exchange DE pair with HL pair 



5,5. Arithmetic Logic Unit Operations, 

Instructions which act upon the single precision accumulator to perform 
arithmetic and logic operations are 



ADD 


e3 


ADD 


B 


Add register given by e3 to accumulator 
without carry (e3 must produce one of A, 
B, C, D, E, H, or L) 


ADC 


e3 


ADC 


L 


Add register to A with carry, e3 as above 


SUB 


e3 


SUB 


H 


Subtract reg e3 from A without carry, 
e3 is defined as above 


SBB 


e3 


SBB 


2 


Subtract register e3 from A with carry, 
e3 defined as above 


ANA 


e3 


ANA 


1+1 


Logical "and" reg with A, e3 as above 


XRA 


e3 


XRA 


A 


"Exclusive or" with A, e3 as above 


ORA 


e3 


ORA 


B 


Logical "or" with A, e3 defined as above 


CMP 


e3 


CMP 


H 


Compare register with A, e3 as above 


DAA 








Decimal adjust register A based upon last 
arithmetic logic unit operation 


CMA 








Complement the bits in register A 


STC 








Set the carry flag to 1 
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CIC Complement the carry flag 

PLC Itotate bits left, (re) set carry as a side 

effect (high order A bit becomes carry) 
RRC Rotate bits right, (re) set carry as side 

effect (low order A bit becomes carry) 
RAL Rotate carry/A register to left (carry is 

involved in the rotate) 
RAR Rotate carry/A register to right (carry 

is involved in the rotate) 



EAD e3 DAD B Double precision add register pair e3 to 

HL (e3 must produce B, D, H, or SP) 

5.6. Control Instructions. 

The four remaining instructions are categorized as control instructions, 
and are listed below 



HLT Halt the 8080 processor 

DI Disable the interrupt system 

EI Enable the interrupt system 

NOP No operation 



6. ERROR USAGES. 

When errors occur within the assembly language program, they are listed as 
single character flags in the leftmost position of the source listing-. The 
line in error is also echoed at the console so that the source listing need 
not be examined to determine if errors are present. The error codes are 

D Data error: element in data statement cannot be 

placed in the specified data area 

E Expression error: expression is ill-formed and 

cannot be computed at assembly time 

L Label error: label cannot appear in this context 

(may be duplicate label) 

N Not implemented: features vtfiich will appear in 

future ASM versions (e.g., macros) are recognized, 
but flagged in this version) 

Overflow: expression is too complicated (i.e., too 

many pending operators) to computed, simplify it 

P Phase error: label does not have the same value on 

two subsequent passes through the program 
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R Register error: the value specified as a register 

is not compatible with the operation code 

V Value error: operand encountered in expression is 

improperly formed 



Several error message are printed vtfiich are due to terminal error 
conditions 

NO SOURCE FILE PRESENT The file specified in the ASM command does 

not exist on disk 

NO DIRECTORY SPACE The disk directory is full, erase files 

vrtiich are not needed, and retry 

SOURCE FILE NAME ERROR Improperly formed ASM file name (e.g., it 

is specified with ■•?'■ fields) 

SOURCE FILE READ ERROR Source file cannot be read properly by the 

assembler , execute a TYPE to determine the 
point of error 

OUTPUT FILE WRITE ERROR Output files cannot be written properly, most 

likely cause is a full disk, erase and retry 

CANNOT CLOSE FILE Output file cannot be closed, check to see 

if disk is write protected 



7. A SAMPLE SESSION. 



The following session shows interaction with the assembler and debugger in 
the development of a simple assembly language program. 



(7 



asm sort. a.%st^kU SoPT Ask. 



CP/M ASSEMBLER - VER 1 . 8 

083H USE FACTOR <% <jf "t^U* <*Scl OO Jo fF CU^ca^vwU J 



END OF ASSEMBLY 



DIR SORT. * 



SORT ASM SdtJKt -f\U 

SORT BAK Uif 

SORT PRN fiU (ifl^iUs'W* cUurA^rs; 

SORT HEX wacU*- oxk 

A >TYPE SORT . PRN-, 



,^ ^ 

8100 * 

0180 214601* 3 SORT: 
0103 3601 
8105 214701 
8108 3600 



SORT PROGRAM IN CP/M ASSEMBLY LANGUAGE 

START AT THE BEGINNING OF THE TRANSIENT PROGRAM AR 

ORG 100H 



LXI 
MVI 
LXI 
MVI 



H> SU 
M> 1 
H, I 
M> 8 



ADDRESS SWITCH TOGGLE 

SET TO 1 FOR FIRST ITERATION 

ADDRESS INDEX 

I = 



010A 7E 
018B FE09 
010D D21901 



COMP: 



COMPARE I UITh ARRAY SIZE 



MOV 
CPI 
JNC 



A* M 
N-l 
CONT 



A REGISTER = I 

CY SET IF I < <N-1> 

CONTINUE IF I <= <N-2> 



8110 214601 
0113 7EB7C20001 



END OF ONE PASS THROUGH DATA 

LXI H, SU ;CHECK FOR ZERO SWITCHES 

MOV A,M! ORA A! JNZ SORT ; END OF SORT IF SW*B 



0118 FF 



RST 7 



;GO TO THE DEBUGGER INSTEAD flF RE H 



0119 5F16002148CONT 
0121 4E792346 



0125 23 

8126 965778239E 
812B DA3F01 



CONTINUE THIS PhSS 

ADDRESSING I > SO LOAD AV<I> INTO REGISTERS 
MOV E.A! MVI D,0! LXI H,AV! DAD D ! DAD D 
MOV CM! MOV ^ C! INX H! MOV B,M 

LOU ORDER BYTE IN A AND C, HIGH ORDER BYTE IN B 

MOV H AND L TO HDDRESS AV < I + I ) 
I NX H 

COMPARE VALUE WITH REGS CONTAINING AV(i> 

SUB M! MOV D,A! MOV A, B ! INX H! SBB M ; SUBTRACT 

BORROW SET IF AV<I + 1> > AV< I > 

JC INCI ;SKIP IF IN PROPER ORDER 



012E B2CA3F01 



CHECK FOR EQUAL VALUES 

ORA D! JZ IHCI /SKIP IF AV( 1 ) * AVM+l) I? 



9132 56782B5E 
0136 712B722B73 



813B 21460134 



013F 2147B134C3INCI 



MOV D , M ! MOV Mi B! DCX H! MOV E > M 

MOV M,C! DCX H! MOV M» D ! BCX H! MOV Mi E 

INCREMENT SWITCH COUNT 
LXI H,SU! INR M 

INCREMENT I 

LXI H, I ! INR M! JMP COMP 



0146 
0147 
0148 
080A 
015C 
A >TYPE 



00 SU: 

I : 

058864001EAV: 




DATA 
DB 

DS 
Did 
EG U 
END 



DEFINITION SECTION 

; RESERVE SPACE FOR SWITCH COUNT 

t ;SPACE FOR INDEX 

5i 100 j 3 6. 56, 20i 7, 1008, 30 0, 100* -327 67 



<*-AV )/2 



;COMPUTE N INSTEAD OF PRE 



1001000021 460 13601 21 478 136007EFEB9D2 1901 40 
1 00 110 00 214 60 17EB7C2 00 IFF 5F 16002 148011983 
18012000194E79234623965778239EDA3FB 1B2CAA7 
100 130 00 3F 015670 2B5E712B72 2B 73214 60 1 34 21C7 
07014 00047 0134C38A010 06E 

100 14 80005 06 400 1E00 3 2001 4 00 07 00E8B32C 01 BB 
646 1580064060 186BE 

0000080000 



] 



J 



A > DDT SORT. HEX > 6d*uf\ ***v- 



16K DDT VEft 1.8 v 



XP 



P*0000 100^ CWlvvj£ ?C M 



UFFFF 



C8Z0M0E0I 8 

C0Z8M0E0I0 
C0Z8M0E010 
C0Z8M0E010 
C0Z8M0E0I0 
C0Z0M0E0I0 
C0Z8M0E010 
C1Z0M1E010 
C1Z0M1E0I0 
C1Z0M1E0I0 
C1Z8M1E0I0 
C0Z0MBE0I0 
C0Z0M0E0I0 
D0Z0M0E0I 
C0Z8M0E0I0 
C0Z0M0E010 
C0Z0M0E8I0 
-A18D 



810D JC 119. cUi 
one; ^ 



A = 80 


B-0606 


D 


= 8000 


H 


= 0000 


S=01 00 


P = 


100 


LXI 


Ht 146 






















A=0 1 


B=0000 


D 


= 8000 


H 


= 0146 


S=01 00 


p* 


0100 


LXI 


H, 0146 


A = 01 


B=B000 


D 


= 0000 


H 


= 0146 


S=01 00 


p= 


103 


MVI 


n, 01 


A=0 1 


B=0000 


D 


= 0000 


H 


= 0146 


S=01 08 


p« 


185 


LXI 


H, 0147 


A=0 1 


B=B0B0 


D 


= 0000 


H 


= 8147 


S=01 8 


p= 


0108 


MVI 


M, 00 


A = 01 


B=0000 


D 


= 0000 


H 


= 0147 


S=01 00 


p= 


18A 


MOV 


A. M 


A = 00 


B=0000 


D 


= 0000 


H 


= 8147 


S=01 00 


p= 


016B 


CPI 


89 


A = 00 


B=0000 


D 


= 0000 


H 


= 01 47 


S=01 80 


p= 


16D 


JNC 


0119 


A=00 


B=B000 


D 


=0000 


H 


= 8147 


S=01 80 


p= 


0110 


LXI 


H, 0146 


A = 00 


B=B000 


D 


= 0000 


H 


= 81 46 


S=01 00 


p= 


113 


MOV 


A, M 


A*01 


B=00B0 


D 


= 0000 


H 


= 01 46 


S=0100 


P" 


0114 


ORA 


A 


A = 1 


B=B000 


D 


= 0000 


H 


= 0146 


S=01 00 


p= 


8115 


JNZ 


0100 


A = 01 


B=0000 


D 


= 0000 


H 


= 0146 


S=0100 


p= 


0100 


LXI 


H/ 146 


A = 01 


B=B000 


D 


= 0000 


H 


= 01 46 


S=0100 


p= 


103 


MVI 


M, 01 


A = 1 


8=0000 


D 


= 8000 


H 


= 81 46 


3=01 00 


p= 


105 


LXI 


H, 0147 


A = 1 


B=0000 


D 


= 8000 


H 


= 0147 


S=01 00 


p= 


188 


MVI 


M, 00 


A = 1 


B=0000 


D 


= 0000 


H 


= 0147 


S=01 08 


p= 


18A 


MOV 


A, M*01 



l*6H 



J 



I? 



-XP 



P=018B 100 
P 

-T10. 



yesc^ q>royam Oov^c&r Uicfc.-"fc> 



rA7AMAP ATA 


A 
H 


= a ft 




D 


-a aa a 

c BwDD 


if 


-a a au 


LI 

n 


s ft 1 d 7 


= ft 1 aa 


ps ft t ft ft 


t XT 

LAI 


u ft 1 4 6 




A 

H 


— ft a 

— V V 


D 


- ft ft ft ft 
-D WOO 


ft 
u 


= ft ft ftft 


u 
n 


— ft 1 d £ 


G - ft 1 ftft 


ft 1 ft 7 


M V T 
1 1 Y 1 


M . ft 1 
1 1 * u 1 


PQ7AMQIT Al ft 


H 


— & a 

— <3 


a 



— a a a ft 


j\ 
U 


— a ft fta 


u 
n 


— a 1 a £ 
-W I 


Q — ft 1 ftft 


P — ft 1 ft R 


Lai 






M 


= ft ft 


D 


— ft ft ft ft 
*" O W O v 


ft 


= ft ft ft ft 
— O w v w 


n 




— a \ 

U — V J t? w 


P = ft 1 ft ft 


II v 1 


M ftft 

1 1 t V O 


r Pi 7 ft HRFAT Ci 


A 
M 


= fi ft 


D 
D 


-ft ft ft ft 
~ V V u O 


ft 


= ft ft ftft 

"wo vO 


u 
n 


= ft 1 d 7 


e - a 1 ftft 


p- ft 1 ft A 
r — ion 


IIU Y 


n ^ II 1 

ft ^ y 

%> i 1 j 


Pft 7ft Mft F ft T ft 


A 

n 


= ft ft 

U V 


D 
O 


= ft ft ft ft 


ft 


= ft ft ftft 

W V V w 


u 

n 


= ft 1 d 7 


Q = ft 1 ftft 


ft 1 ft ft 


O 1 X 


P 1 7ft M 1 P ft T ft 


A 
H 


= ft ft 


D 
D 


= ft ft ft ft 

— 


ft 


= ft ft ftft 


£1 

n 


r= ft 1 d 7 


C s ft 1 ftft 


p - ft 1 ft ft 

r **■ 1 t. 1 J 


.1 r 


P" 1 7QM1 r&T 

L 1 ion 1 bol t) 


A 

H 


— Ci a 

— U 


O 
D 


— ft d Ok ft 

— u vo to 


ft 
V 


— Gt a Ct 


Ll 

n 


-Wl 7f 


c — a i Ct ct 
- 1 t> 


P — ft 1 1 Q 


nuY 


C ^ H 


C1Z0M1E010 


A 


= 80 


8 


= 8000 


D 


= 0000 


H 


= 81 47 


S=01 08 


P = 1 1 A 


MVI 


D, 00 


C120M1E0I0 


A 


= 00 


B 


= 0000 


D 


= 0000 


H 


= 014? 


S=01 00 


P = 11 C 


LXI 


H, 148 


C1Z8M1E0I0 


A 


= 00 


B 


= 0000 


D 


= 0000 


H 


= 0148 


S=01 80 


P=0 1 1 F 


DAD 


D 


C0Z0M1E8I0 


A 


= 00 


B 


= 0000 


D 


= 0000 


H 


= 0148 


S=0108 


P=0i20 


DAD 


D 


C0Z0M1E0I0 


A 


= 00 


B 


= 8008 


n 


= 8808 


H 


= 8143 


s=ei 88 


P=8121 


MOV 


c , « 


C0Z8M1E0I0 


A 


= 80 


B 


= 8005 


D 


= 0008 


H 


= 0148 


S = 8 1 8 


P = 8 122 


110 V 


A> C 


C6Z8M1E0I0 


A 


= 05 


B 


= 0005 


D 


= 0800 


H 


= 01 48 


S=01 80 


P=8 123 


I NX 


H 


C0Z0M1E0I0 


A 


= 85 


B 


= 0005 


D 


= 0000 


H 


= 0149 


S=01 00 


P = 124 


MOV 


B / M*81 2 



-1100^ 

0100 LXI 
0103 MVI 



0105 
0188 
010A 
010B 
010D 

01 10 

0113 
8114 
81 15 

- L ; 

81 18 
8119 
81 1A 
Bl 10 



LXI 

MVI 

MOV 

CPI 

JC 

LXI 

MOV 

ORA 



H, 8146 
M, 81 
H, 8147 
M, 88 
A, M 
09 

0119 
H/ 14 6 
A, M 
A 



JNZ 8180 



J 



RST 
MOV 
MVI 
LXI 



0? 
E, A 
D> 00 
H, 0148 



1 V (A 




" ^ loot at IccPi^ pw^gawi ^Wtf moJe ^ locf 1*13 l>Mefivu4^) 



-G, 1 IB 
-T4 



C0Z0M0E0I8 A»38 B=B064 D»0086 H»8156 

C0Z0M0E0I0 A=38 B=0064 D=3806 H=0156 

C0Z0M0E0I0 A=00 B=0064 D=3806 H=0156 

C0Z0M0E0I0 A=88 B=0064 D=3806 H=8157 
-D148 



S=0100 P=0127 MOV D,A 

S=0100 P=0128 MOV A,B 

S=8100 P=0129 INX H 

8=0108 P=012A SBB M*012B 



1 48 05 00 07 00 14 00 IE 00 J 

0150 32 00 64 00 64 00 2C 01 E8 83 81 80 00 00 00 00 2 D I) , 

01 60 00 00 00 00 00 00 00 00 00 tiu 80 80 00 08 80 00 



-&0- reW* CP/M 

DDT SORT.HEX^ reload -\\a£ mc«^vj ima^* 

16K DDT VER 1.0 
NEXT PC 
015C 0009 
-XP 

P«0008 100^ $ek fC Ao tfc^wutfj cjf^r^mcum 
~L18D^ IdfiJl CpCtfAd 

818D jnc ei\s^ 

0110 LXI H/0146 
~ le* ia/v-Ua runout- 

~A18D^ a**^***' cp c ^ e 
010D JC 119, 

0110^ 



0100 


LXI 


H, 0146 


0103 


MVI 


M, 1 


0105 


LXI 


H, 0147 


0108 


MVI 


M, 00 



0183 NVI «,e^ 



8ie5y 

SAVE 1 SORT. COM , 5av€ 1 f©* ft* «*»0 iisfc vCv CftV- 



u/* Ueive "Vo reload l*fer 
A >DDT SORT. COM , r «Aa*+ " WT 

16K DDT VER 1.0 

llll eiee '«*.• tie cU s . "»W 

0148 05 80 07 08 14 00 IE 88 _ 

0150 32 00 64 00 64 00 2C 01 E8 03 01 80 00 80 00 80 2.D.D., 

8160 00 00 08 00 88 08 00 08 80 68 00 88 08 80 80 88 

8178 08 00 88 88 88 88 88 88 88 88 88 88 08 80 80 08 



ED SORT.ASH^ fvokt cUwu^S -\o <V\jiv\*4 -^voy<k»»~ 

♦ N.ergeTy -fuia V" 

W MVI M, i I * 

<?u^<Me Ue^ -Utf ^ ^ ; ADDRESS INDEX 

* V MVI 11,1 i SET TO 1 FOR FIRST ITERATION 



*KT; toll lae**<Huf€ Ur* 
' LXI H,I 



* 1^ imM ***** 



/ADDRESS INDEX 
M,0 ;ZER0 SU 



LXI H, I ; ADDRESS INDEX 

*NJN ' 



JNC*T, 

CONT i CONTINUE IF I <= <N-2> 

* - 2 D I C<^2)B L 

JC CONT CONTINUE IF I <= (N-2> 

ASM SORT. ftAZjT"*^ ?™ 

CP/H ASSEMBLER - VER 1 . 

015C V^t oJWbrto "(o fl**5U*Ut 
003H USE FACTOR 
END OF ASSEMBLY 

DDT SORT.HEX^ cUan^s 

16K DDT VER 1. 
NEXT PC 
815C 0000 
- G 1 & 5 



-D148 



0148 05 80 07 00 14 00 IE 00 
0150 32 00 64 00 64 00 2C 01 E8 03 01 80 00 00 80 00 2.D.D 

01€0 00 00 00 00 00 00 00 00 00 00 00 00 00 00 60 00 



IX 



